home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / chat / ircii-2.8he / ircii-2 / help / IF < prev    next >
Encoding:
Text File  |  1993-05-04  |  3.8 KB  |  96 lines
  1. Usage: IF (<variable-expression>) {<true-command/s>} [{<false-command/s>}]
  2.   IF tests the value of the variable expression for truth. An
  3.   expression is true if it is either a non empty string or a non
  4.   zero number. If the expression is true, the true-commands are
  5.   executed. If it is false, and the false-commands are given, they
  6.   are executed. Usually the expressions will be formed by using
  7.   combinations of the following:
  8.     ( exp )                ( exp1 ^^ exp2 )
  9.     ( exp1 == exp2 )        ( exp1 >= exp2 )
  10.     ( exp1 != exp2 )        ( exp1 <= exp2 )
  11.     ( exp1 >  exp2 )        ( exp1 || exp2 )
  12.     ( exp1 <  exp2 )        ( exp1 && exp2 )
  13.         
  14.   Here exp is evaluated as though it were in ${} which means that 
  15.   if (blah)  expands the contents of $blah.  Numbers are treated 
  16.   as constants and thus to expand $0 it must be passed to the 
  17.   regular parser with [].   eg.  IF ([$0]) ...
  18.  
  19.   IF (!exp)  is also possible which will negate a number or a string.
  20.   In the other expressions, if both exp1 and exp2 expand to numbers, 
  21.   then the following cause true-command to be executed:
  22.     ==     if exp1 is equal to exp2
  23.     !=    if exp1 is not equal to exp2
  24.     >    if exp1 is greater than exp2
  25.     <    if exp1 is less than exp2
  26.     >=      if exp1 is greater than or equal to exp2
  27.     <=     if exp1 is less than or equal  to exp2
  28.     ^^     Logical XOR of exp1 and exp2 (1 ^^ 1) == 0 
  29.          (1 ^^ 0) or (0 ^^ 1) == 1
  30.     ||     Logical OR of exp1 and exp2
  31.     &&    Logical AND or exp1 and exp2
  32.  
  33.   Otherwise, false-command (if present) is executed.
  34.   If both exp1 and exp2 are non-numeric, then the above operations
  35.   are string value comparisons.  And for the logical operations 
  36.   A NULL string is treated as 0 with the possible exception of the ^^
  37.   operator.
  38.  
  39.   To put a string in an expression it must be passed to the 
  40.   regular parser with [].   eg IF ([string1] == [string2]) ..
  41.   All string comparisons are case-insensitive: so ([Hello]==[HELLO])
  42.   is true.  
  43.  
  44.   Examples:
  45.     IF (C) { set input_prompt $C } { set -input_prompt }
  46.     IF (C!=0) { set input_prompt $C } { set -input_prompt }
  47.  
  48.   Both of the above evaluate the same way, since $C will either expand 
  49.   to your current channel or 0 if none.  Notice the (C) format which 
  50.   means that it will expand exactly like ${C}.
  51.  
  52.   $ expansion is always performed on the contents of an the true-commands
  53.   and false commands, regardless of the setting of the INPUT_ALIASES
  54.   variable. 
  55.  
  56.     IF (USER==[ms5n]) { echo Hello Mike! } { echo Who the hell are you? }
  57.  
  58.   This example will look for an ASSIGN'd variable named USER, and if found
  59.   replace it and compare to ms5n.  If no ASSIGN'd variable exists, it
  60.   will check the environment variables for USER and return that.  
  61.  
  62.     IF (index > max*2) { echo Limit reached }
  63.   This checks the ASSIGN'd variable against the ASSIGN'd variable
  64.   max times 2 and displays "Limit reached" if the first is greater than
  65.   the second. It does nothing if this is not true.
  66.  
  67.   IF's can now be imbedded within each other. It is inconvient to write it 
  68.   out on a single line, so I will show the format needed in a script file.
  69.  
  70.   if (time() - lasttime > 600)
  71.   {
  72.     if (thud == [gone home])
  73.     {
  74.       echo Bill went home over ten minutes ago
  75.       echo $stime($time())
  76.     }
  77.     {
  78.       echo Bill is still here.
  79.     }
  80.   }
  81.  
  82.   This will first expand the function time() and the ASSIGN'd var 'lasttime'
  83.   to their current values, subtract (seconds) and see if its more than 
  84.   600 seconds, (10 minutes).  If that is true, then it checks to see if the
  85.   ASSIGN'd var 'thud' equals the string "gone home".  If that is ALSO true
  86.   then it will echo "Bill went home over ten minutes ago" and the current
  87.   date and time.  If the second IF is not true then it will display
  88.   "Bill is still here.".   Note there is no 'false' clause for the first
  89.   IF.
  90.  
  91. See Also:
  92.   @
  93.   FOREACH
  94.   WHILE
  95.   expressions
  96.